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Module Main.cpp 



Main.cpp_1(2) 



/* This is the System mainline. A 
configuration file is read and if 
successful, services are started. */ 




Initialize Windows Sockets 



SET wVersionRequested; 
WSAStartup, 



r-else- 



Sat console handlers and ; 
start Ready/Vef services. * 



IReadConfigFtle 



ControlHandter; 
LaunchServices; 



0 ® 

Figure 1 
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Module Handlers.cpp 



handlers.cpp_1(10) 



FUNCTION 
getDestlp 




r Retrieves the destination address 
from the client table using source IP 
and port number */ 



GET entry from client 
table, 

GET connection info from 
table entry, 



Based on source IP 
address and port number, 
retrieve the destination IP 
address from the client 
connection table. 



Figure 2 



FUNCTION 
connectToHost 



r Uses Windows sockets to 
connect to a particular IP address 
and port */ 



Figure 3 




rc=w_connect 




r 



SOCKET ERROR 
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Module Handlers.cpp 



FUNCTION 
proxyMessage 



I* Read data packet from the source 
socket and direct it to the destination 
socket */ 



handlers.cpp_2(10) 



src_sock 
dst_sock 





r 


receive 


src_sock 



Figure 4 



send dst_sock 




FUNCTION 
dataHandler 



r Checks for network traffic on 
the client-side and server-side 
and passes these messages to 
the call proxyMessage */ 



Figure 5 




No 
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Module Handlers.cpp 



handlers. cpp_3( 10) 





r Listens for activity on the 
appropriate socket and 
determines the direction of 
the data, calling 
proxyMessage */ 



Figure 6 



listen for a 
send or receive 



who sent the 
message? 



client 



server 



proxyMessage 
(client -> server) 



proxyMessage 
(client -> server) 



FUNCTION 
genericTCPProxy 



I* Initialize a socket on the given 
client and server ports and begin 
a new thread (handler function) to 
handle activity on that socket */ 



c_port 

s_port 

handter_fn 

protocoLname 

ProtocoLnumber 

backlog_size 



i 



create a socket to accept 
connections on the 
client-side adapter 



Figure 7 



listen on this socket 
accept the socket 



start the handlerjn 
thread 
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Module arpspoof.cpp 



arpspoof.cpp_1(5) 



FUNCTION 
RnetArpSpoofer 



1* Handles any ARP requests by 
waiting for an ARP packet, 
responding with the System 
client-side IP address, and 
inserting the client into the 
routeTable */ 





Initialize packet driver 
for client-side adapter 




r 


Wait for a pa 


cket to amve 



Is the packet 
an ARP 
packet? 



YES 

1 



Add or update entry to 
route table. 
Delete old entries. 




r 


Send an AF 
of the citen 
add 


tP response 
t-side MAC 
ess. 



Figure 8 
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Module dnsproxy.cpp 



dnsproxy.cpp_J(9) 



FUNCTION 
RnetDnsHandleRqst 



SOURCE 


DEST 










YES 



r Processes a DNS query. If it 
is a local name, a response is 
made that delivers the 
System client-side IP 
address. If it is not, the entry is 
added to the DNSTabieand 
the request forwarded to the 
DNS server */ 



1 


r 




r 


Add source to DNSTabte 




Send an ARP response 
of the client-side MAC 
address. 




r 






Forward query to the DNS 
server 







Figure 9 
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Module dnsproxy.cpp 



dnsproxy. cpp_2(9) 



FUNCTION 
RnetDnsRtnResp 



SOURCE 


DEST 






r 



f* Forwards a response from 
the DNS server to the 
System client If the DNS 
server does not respond with a 
success, System ' responds 
with a default response: its 
client-side IP address 7 




Build default response 



Get client IP from 
ONSTable 



Send response to client 



Figure 10 
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Module dnsproxy.cpp 



dnsproxy.cpp_3(9) 



FUNCTION 
RnetDnsProxy 




Figure 11 



Initialize 0 
addre 
DNSIm 


NS Server 
ss into 
JtADOR 




r 


Initialize cfient*s»de socket 
to CiientlnetAddr 




r 


Initialize serv 
to Serve 


er-side socket 
rtnetAddr 



J* Initialize client-side and server- 
side sockets listening for DNS 
traffic When a DNS packet 
arrives on the client-side, call 
RnetDnsHandleRqst. Packets 
arriving on the server-side are 
passed to RnetDnsRtnResp */ 



Wait for DNS 
packet amvai 



Which socket? 



CLIENT-SIDE 



SERVER-SIDE 



RnetQnsHandieRqst 



RnetDnsRtnResp 



Jose A. Rueda et al 



^U^J. 7U r d $ fa !) 6-9- 



Sheet 9 of 22 M^t^o 
Battison - 84201 -502 ADB 



Module recv.c 



recv.cj (3) 



FUNCTION 
recv.c - Additions 




/* For each packet that arrives to the driver, 
create a UDP packet with destination 
information and send to transport layer on 
the System port (60). Add client 
information to DestAddrPool if UDP packet 
or if a handshaking TCP packet. Delete 
DestAddrPool entry if TCP FIN 7 



YES — i 



SET RESET in 
DestAddrPool if 
PACKET hasACKand 
SYN flags 



REMOVE entry from 
DestAddrPool if 
RESET 



Change DastIP in 
PACKET to ReadyNet 
client-side IP 




r 


Set IP and TCP/UDP 
checksums 




r 


Send PA 
transpc 


CKETto 
rt layer 



is PACKET 
TCP or UDP? 



YES 



- COPY orgtnat destlp to data portion of 
RN UDP 

- COPY FIN value 

- COPY sourcelP and port 
-SET destIP to ReadyNet client-side IP 

- SET protocol field to UDP 

- SET UDP and iP length 

- SET destPORT to ReadyNet port (60) 



SET !P and UDP 
checksums 



SET PACKET length 
and send RNJJDP to 
transport layer 




Figure 12 
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Module send.c 



send.c_1(2) 



FUNCTION 
send.c - Additions 



( 


PACKET 
TABLE 


) 




r 


Copy PACKET into BUFFER 


1 


r 




Is BUFFER a 
TCP or UDP 
packet? 




r Sends packets to the 
System clients. Changes 
destination IP and MAC 
addresses according to 
DestAddrPool and 
recalculates checksums 
before sending the packet to 
the client */ 



GET client information 
from TABLE and change 
SUFFER IP and MAC 




Mark finished if FIN flag 
Mark acknowledged is ACK flag 
Clear TABLE entry if ail flags set 



NO 



NO 




- Calculate new IP checksum 
for BUFFER 

- Calculate new TCP/UOP 
checksum for BUFFER 

- COPY BUFFER to PACKET 



1 


f 


Change BUFFER source 
port to original port 


-NO 





Figure 13 
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System Server 



System 's 




System 
Client Subnet 



IP 200.10.5.1 A 



ARP Request: 

Target MAC. FF FF.FF FF.FFFF 
Target IP Address 192.168 3 5 
Sender MAC 00.55 44.33 22.11 
Sender IP Address- 192 168 3 5 



lOBaseT Hub 
1 



ARP Reply: 

Target MAC* 00-55*44-33 22: 1 1 
Target IP Address: 192.168.3.5 
Sender MAC: 00:1 1.22.33 44 55 
Sender IP Address- 192.168 3 5 



Visiting 
Client A 




Visiting 
Clients 




IP 192.168.3.5 
Subnet 255.255.255.0 
MAC: 00:55:44:33:22:11 



IP 192.168.3.5 
Subnet 255.255.255.0 
MAC 00:11:22:33:44:55 



Visiting 
Client C 



IP 157.100.10.1 
Subnet 255.255.255.0 
MAC 00:AA:BB:CC:DD:1 1 




Figure 15 
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Figure 16 




^ \ ^ y 

IP 192^X5 Vl9ll68.3.5 ITT57J0ai0.1 

Subnet 255.255.255.0 Subnet 255.255.255.0 Subnet 255.255.255.0 

MAC: 00:55:44:33:22:11 MAC 00:11:22:33:44:55 MAC 00:AA:BB:CC:DD:1 1 



Figure 17 
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Figure 18 
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System Server 



System 's 
Gateway 



ARP Request: 

Target MAC 00 22 33 44 55 AA 
Target IP Address 192 163 3 5 
Sender MAC 00 55 44 33 22 11 
Sender I? Address 192 168 3 5 




IP 200 10.5 

MAC 00.22:33 :44:55..\A 1 



ARP Request: 

Target MAC FF FF FF FF FF FF 
Target IP Address 192 168 3 5 
Sender MAC 00 55 44 33 22 U 
Sender IP Address 192 168 3 5 




System 
Client Subnet 



Ethernet Switch 



IP 192.168.33:::;;. 
: 'Subnet 255.255.255.0 • ^ 
MAC: 00:55:44:33:22:1 ki 



Subnet 255255.255.6 
MAC 00:11:22:33:44:55 



Room 106 



ip : a'57JOoao:i : ^:;:-: 

Subnfit255.255i55:6: : - 
MAC 0O:AA:BB:CC:DD>iy 



Figure 19 
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Figure 20 
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Figure 21 
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to Gateway Server 



Figure 22 



System Server 



System 's 
Gateway 




Printer 

supporting TCP/IP, NetBEUI 
and EtherTalk (i.e. AppleTalk) 



Visiting 
Client A 



Macintosh 

(running MacTCP and 
AppleTalk) 



PC (running TCP/IP and 
possibly NetBEUI) 



PC (running TCP/IP and 
possibly NetBEUI) 



Figure 23 
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Figure 24 




Figure 25 
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Visiting 
Client A 



Visiting 
Client 



addresses: * 



Registered IP Address 





Figure 26 




IP 222.10.10.1 (Registered) 



Figure 27 
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Visiting 
Client A 



Visiting 
Client B 



Visiting 
Client Y 



Visiting 
Client Z 



Figure 28 




System Server 
AKV Spooler, 
^System NDIS 
Intermediate Driver, IP 
Forwarding Enabled 



Visiting 
Client A 

Visiting 
Client B 

Visiting 
Client C 

Visiting 
Client D 



Visiting 
Client N 



Hotel Hotel Gateway 

Administration 



lOBase-T 




PCI/ISA Concentrator 




System Server 

with n x AKF bpooter, 
DNS Spoofer, ReadyNet 
NDIS Intermediate 
Driver, & Proxy Program 



Some Registered Class 
C IP address 
Gateway to the Internet 



System 's 
Gateway Server 



Figure 29 
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Port 
1051 



System client 

Port - 
1050 



lit 
mm 



Port 
1060 



Port 
1051 



System server 



Perceived connection 



ms\ 



Destination 

4 



Port 
1051 



Figure 30 



WindowNT TCP/IP stack 
TCP/IP 



Virtual Adapter [3] 

System Driver 

System Transport 




Virtual Adapter [3] 

System Driver 
System Transport 








Adapter Driver 
Adapter [1] 




Adapter Driver 
Adapter [2] 



I 



□ □□□aa 

i.i..ii.tt..i 

Network Adapter Network Adapter 




Figure 31 



